ÂQuickDraw GX ObjectsContents Figures, Tables, and ListingsAbout This BookJFigure P-1 Roadmap to the books of the Inside Macintosh QuickDraw GX suite What to ReadChapter Organization Conventions Used in This Book
Special FontsTypes of NotesNumerical Formats!Type Definitions for Enumerations
IllustrationsDevelopment Environment
Developer Products and Support Introduction to QuickDraw GXWhat is QuickDraw GX?Color Graphics
TypographyPrintingWhat QuickDraw GX is Not
QuickDraw GX Objects$Figure 1-1 Some QuickDraw GX objects How QuickDraw GX Defines Objects'Advantages of an Object-Based Structure Kinds of QuickDraw GX Objects
Shape ObjectsSupporting Objects4Figure 1-2 A shape object and its referenced objectsPrinting ObjectsFigure 1-3 Printing objectsObject Properties&Default Objects and Default Properties'Adding Custom Behavior With Tag ObjectsObjects and Memory*Application Memory and QuickDraw GX Memory&Sharing and Multiple Object References Owner CountCloning*Automatic Loading and Unloading of Objects8Direct Access to Object Structure: Locking and Unlocking8External Storage of Objects: Flattening and Unflattening Drawing and Hit-Testing ShapesDrawingMapping and Clipping Figure 1-4 Effects of mapping View-Related Objects Figure 1-5 How shapes are drawn+The Drawing Sequence: Coordinate Conversion(Figure 1-6 A rectangle in geometry spaceAFigure 1-7 A rectangle in local space (transform mapping applied)BFigure 1-8 A rectangle in global space (view port mapping applied)DFigure 1-9 A rectangle in device space (view device mapping applied) Hit-Testing+Figure 1-10 Parts of a line for hit-testingPrinting With QuickDraw GXBasic Printing FeaturesHFigure 1-11 Dragging a document to a desktop printer icon on the desktop$Custom Dialog Boxes and Page Formats@Figure 1-12 Printing a single document that has multiple formatsAdvanced Printing FeaturesBFigure 1-13 Printing the pages of a document on different printers(The QuickDraw GX Programming Environment Setting Up QuickDraw GX MemoryHandling Errors Debugging$Debugging and Non-Debugging VersionsDebugging With GraphicsBug5Listing 1-1 Sample GraphicsBug Heap Dump (HD) listing*Programming Consistencies and ConveniencesObject Behavior Functions and Function ResultsFunction Parameters.Table 1-1 Convenience constants for parametersCode Naming Conventions%Relationship to the Macintosh Toolbox1Summary Table and Diagram of QuickDraw GX Objects)Table 1-2 QuickDraw GX Objects(continued)8Figure 1-14 Properties of the basic QuickDraw GX objects
Shape ObjectsAbout QuickDraw GX Shapes3Figure 2-1 Basic components of a QuickDraw GX shapeAbout Shape ObjectsShape Properties.Figure 2-2 The shape object and its properties
Shape Type Table 2-1 Shape types(continued)Shape Geometry
Shape Fill Table 2-2 Shape fills(continued)%Figure 2-3 Even-odd and winding fills:Table 2-3 Valid shape fills for each shape type(continued)Shape Attributes%Table 2-4 Shape attributes(continued)Default ShapesModifying Shape PropertiesSaving and Restoring Shapes Drawing and Hit-Testing Shapes-Summary Diagram of Shape Types and Geometries=Figure 2-4 Shape geometry for each type of QuickDraw GX shape
Using Shape Objects'Creating and Manipulating Shape Objects-Getting and Setting the Default Shape Objects'Creating and Disposing of Shape Objects0Determining the Size of a Shape Object in Memory-Copying, Comparing, and Cloning Shape ObjectsCaching Shape Objects#Loading and Unloading Shape Objects$Manipulating Shape Object Properties?Getting and Setting a Shape Object’s Type, Fill, and Attributes.Copying the Geometry From One Shape to Another>Getting and Setting a Shape Object’s Style, Ink, and Transform-Resetting a Shape Object’s Default Properties)Manipulating a Shape Object’s Owner Count3Getting and Setting a Shape Object’s Tag References*Converting Shapes From One Type to Another<Table 2-5 Where to find information on shape-type conversion(Directly Manipulating a Shape’s Geometry1Listing 2-1 Directly accessing a shape’s geometry"Flattening and Unflattening Shapes Listing 2-2 Flattening a shape Listing 2-3 Unflattening a shape3Listing 2-4 A spool function that parses shape data Drawing and Hit-Testing ShapesDrawing Hit-Testing&Figure 2-5 Shape parts for hit-testing Listing 2-5 Hit-testing a line+Shape-Related Functions Described Elsewhere@Table 2-6 Shape-related functions described elsewhere(continued)
Shape Objects Reference Constants and Data TypesThe Shape Object
Shape Type
Shape FillShape Attributes
Flatten FlagsThe Spool BlockThe Hit-Test Info Structure Functions(Creating and Manipulating Shape Objects GXGetDefaultShapeGXSetDefaultShape
GXUnlockShapeGXGetShapeStructureGXChangedShape)Flattening and Unflattening Shape ObjectsGXFlattenShapeGXUnflattenShape Drawing and Hit-Testing Shapes GXDrawShapeGXHitTestShape"Application-Defined Spool Function MySpoolProc
Summary of Shape Objects
Style ObjectsAbout Style ObjectsStyle Object Properties.Figure 3-1 The style object and its propertiesNTable 3-1 Where to go for information on style object properties and functionsThe Default Style Object
Using Style Objects'Creating and Manipulating Style Objects$Creating and Deleting a Style Object-Copying, Comparing, and Cloning Style Objects;Listing 3-1 Building a style list by copying a style object#Loading and Unloading Style Objects$Manipulating Style Object Properties-Resetting a Style Object’s Default Properties8Getting and Setting Style Attributes and Text Attributes)Manipulating a Style Object’s Owner Count3Getting and Setting a Style Object’s Tag References+Style-Related Functions Described Elsewhere@Table 3-2 Style-related functions described elsewhere(continued)
Style Objects ReferenceConstants and Data TypesThe Style Object Functions'Creating and Manipulating Style Objects
Summary of Style Objects Colors and Color-Related ObjectsAbout Color in QuickDraw GX Color Spaces Luminance-Based Color Spaces Figure 4-1 Luminance color space@Table 4-1 Luminance-based color spaces supported by QuickDraw GX@Figure 4-2 Storage formats for two luminance-based color spaces RGB-Based Color SpacesFigure 4-3 RGB color space?Table 4-2 RGB color spaces supported by QuickDraw GX(continued)/Figure 4-4 Storage formats for RGB color spaces.Figure 4-5 HSV color space and HLS color space?Table 4-3 Hue/saturation color spaces supported by QuickDraw GX/Figure 4-6 Storage formats for HSV color spacesCMYK Color Spaces%Figure 4-7 Colors in CMYK color space;Table 4-4 CMYK-based color spaces supported by QuickDraw GX0Figure 4-8 Storage formats for CMYK color spacesUniversal Color SpacesFigure 4-9 CIE color spaceETable 4-5 Universal color spaces supported by QuickDraw GX(continued)0Figure 4-10 Storage formats for XYZ color spaces0Figure 4-11 The I and Q axes in YIQ color space6Table 4-6 Video color spaces supported by QuickDraw GX0Figure 4-12 Storage formats for YIQ color spacesIndexed Color Spaces7Table 4-7 Indexed color space supported by QuickDraw GX2Figure 4-13 Storage format for indexed color space Color Spaces With Alpha Channels<Figure 4-14 Showing color transparency with an alpha channel0Color-Component Values, Color Values, and Colors#Color Conversion and Color Matching8Figure 4-15 Color gamuts for two devices (in CIE space) Color Profiles>Figure 4-16 Profile chromaticities for a device (in CIE space)1Figure 4-17 A profile response curve for a deviceColor-Matching MethodsNFigure 4-18 Maintaining lightness and maintaining saturation in color matchingWhen Color Matching OccursAbout Color Set ObjectsColor Set Properties3Figure 4-19 The color set object and its propertiesColor Values in a Color SetDefault Color Sets
About Color Profile ObjectsColor Profile Properties7Figure 4-20 The color profile object and its properties Profile DataThe Default Color ProfileZero-Length Profiles&Using Colors and Color-Related ObjectsAssigning Colors to Shapes"Assigning Color Profiles to Colors Comparing and Testing Colors Checking for Out-of-Gamut Colors Checking Closeness of ColorsPredicting Drawing Results Converting and Matching Colors=Creating and Manipulating Color Set and Color Profile Objects6Creating and Disposing of a Color Set or Color Profile=Copying, Comparing, and Cloning Color Sets and Color Profiles3Loading and Unloading Color Sets and Color Profiles?Manipulating Object Properties of Color Sets and Color ProfilesManipulating Owner Counts"Getting and Setting Tag References-Manipulating the Colors in a Color Set Object7Manipulating the Profile Data in a Color Profile Object+
Colors and Color-Related Objects ReferenceConstants and Data TypesColor-Component Values Color ValuesThe Color Structure
Color Packing Color SpacesThe Color Set ObjectThe gxSetColor UnionThe Color Profile ObjectColor Functions GXCheckColorGXGetColorDistanceGXCombineColorGXConvertColorColor Set Functions+Creating and Manipulating Color Set ObjectsGXGetDefaultColorSetGXSetDefaultColorSet
GXNewColorSetGXDisposeColorSetGXCopyToColorSetGXEqualColorSetGXCloneColorSet(Manipulating Color Set Object PropertiesGXGetColorSetOwnersGXGetColorSetTagsGXSetColorSetTags.Retrieving and Replacing Colors in a Color Set
GXGetColorSet
GXSetColorSetGXGetColorSetPartsGXSetColorSetPartsColor Profile Functions/Creating and Manipulating Color Profile ObjectsGXGetDefaultColorProfileGXNewColorProfileGXDisposeColorProfileGXCopyToColorProfileGXEqualColorProfileGXCloneColorProfile,Manipulating Color Profile Object PropertiesGXGetColorProfileOwnersGXGetColorProfileTagsGXSetColorProfileTags,Retrieving and Replacing Profile InformationGXGetColorProfileGXSetColorProfileGXLockColorProfileGXUnlockColorProfileGXGetColorProfileStructure,
Summary of Colors and Color-Related Objects Ink ObjectsAbout Ink ObjectsInk Properties,Figure 5-1 The ink object and its propertiesColor
Transfer Mode
AttributesTable 5-1 Ink attributesThe Default Ink ObjectAbout Transfer ModesTransfer Mode TypesArithmetic Transfer Modes$Figure 5-2 Arithmetic transfer modes6Figure 5-3 Blend example with different operand valuesHighlight Transfer Mode"Figure 5-4 Highlight transfer modeBoolean Transfer Modes!Figure 5-5 Boolean transfer modes Pseudo-Boolean Transfer Modes(Figure 5-6 Pseudo-Boolean transfer modes Alpha-Channel Transfer Modes'Figure 5-7 Alpha-channel transfer modesOFigure 5-8 Typical modes used to determine result opacity for the alpha channelFigure 5-9 Anti-aliasingTransfer Mode Color SpaceQFigure 5-10 Automatic conversion of color values during a transfer mode operation Color LimitsCFigure 5-11 Maximum and minimum color-component values in RGB space?Figure 5-12 How minimum and maximum color limits affect drawingHFigure 5-13 How reversed minimum and maximum color limits affect drawingJFigure 5-14 The effects of reversing maximum and minimum in a color spaceSource Color Limits8Figure 5-15 The effect of source color limits on drawingDestination Color Limits=Figure 5-16 The effect of destination color limits on drawingResult Color Limits8Figure 5-17 The effect of result color limits on drawingTransfer Mode MatricesFlagsComponent FlagsTransfer Mode Flags"Summary of Transfer Mode Operation.Figure 5-18 Summary of transfer mode operation
Using Ink Objects%Creating and Manipulating Ink Objects%Creating and Disposing of Ink Objects+Copying, Comparing, and Cloning Ink Objects!Loading and Unloading Ink Objects"Manipulating Ink Object Properties.Getting and Setting an Ink Object’s Attributes(Manipulating an Ink Object’s Owner Count2Getting and Setting an Ink Object’s Tag References*Getting and Setting an Ink Object’s Color 1Getting and Setting an Ink Object’s Transfer ModeWorking With Transfer Modes&Simple Source-to-Destination Transfers$Drawing Selected Parts of the Source,Preserving Selected Parts of the Destination Copying or Preserving LuminanceModifying Luminance$Isolating and Modifying Color RangesMaskingPartial Transparency
Anti-AliasingMaking Color SeparationsTransfer Modes and PrintingInk Objects ReferenceConstants and Data TypesThe Ink ObjectInk AttributesColor StructureTransfer Mode StructureTransfer Mode Flags Transfer Component Structure%Component Modes (Transfer Mode Types)Transfer Component Flags Functions%Creating and Manipulating Ink ObjectsGXNewInk GXDisposeInk GXCopyToInk
GXEqualInk
GXCloneInk"Manipulating Ink Object Properties
GXResetInkGXGetInkAttributesGXSetInkAttributesGXGetShapeInkAttributesGXSetShapeInkAttributesGXGetInkOwners GXGetInkTags GXSetInkTags"Getting and Setting an Ink’s Color
GXGetInkColor
GXSetInkColorGXGetShapeColorGXSetShapeColor*Getting and Setting an Ink’s Transfer ModeGXGetInkTransferGXSetInkTransferGXGetShapeTransferGXSetShapeTransfer
Summary of Ink ObjectsTransform ObjectsAbout Transform ObjectsTransform Object Properties2Figure 6-1 The transform object and its propertiesClipFigure 6-2 A transform clipJFigure 6-3 Modifying a transform clip by subtracting it from another shapeMapping+Figure 6-4 Effects of the transform mappingView Port ListHit-Test ParametersSTable 6-1 Shape parts for hit-testing, from the gxShapeParts enumeration(continued)Default Transform ObjectsUsing Transform Objects+Creating and Manipulating Transform Objects+Creating and Disposing of Transform Objects8Listing 6-1 Creating and disposing of a transform object1Copying, Comparing, and Cloning Transform Objects@Listing 6-2 Cloning a transform to prevent it from being deleted&Implicit Creation of Transform Objects(Manipulating Transform Object Properties Manipulating the Owner Count Getting and Setting the Tag List&Resetting Default Transform Properties2Getting, Setting, and Modifying the Transform ClipSTable 6-2 Constructive geometry operations between transform clips and other shapesUFigure 6-5 Constructive geometry operations with a polygon clip and a rectangle shape-Moving, Scaling, Rotating, and Skewing Shapes Modifying the Transform MappingKListing 6-3 Modifying a shape’s transform with transform-mapping calls onlyYListing 6-4 Modifying a shape’s transform with transform-mapping and shape-geometry callsModifying Shape GeometryBListing 6-5 Modifying a shape’s geometry with shape-geometry calls Manipulating the View Port List*Listing 6-6 Getting and setting view ports Setting Up Hit-Test ParametersTransform Objects ReferenceConstants and Data TypesThe Transform ObjectShape Parts for Hit-Testing Functions+Creating and Manipulating Transform ObjectsGXNewTransformGXDisposeTransformGXCopyToTransformGXEqualTransformGXCloneTransform(Manipulating Transform Object PropertiesGXResetTransform GXGetTransformOwners GXGetTransformTags GXSetTransformTags Getting and Setting the ClipGXGetTransformClip GXSetTransformClip GXGetShapeClip GXSetShapeClip 2Performing Geometric Operations on Transform ClipsGXUnionTransform GXIntersectTransform GXDifferenceTransform GXReverseDifferenceTransform GXExcludeTransform Getting and Setting the MappingGXGetTransformMapping GXSetTransformMapping GXGetShapeMapping GXSetShapeMapping 3Transforming Shapes by Modifying Transform MappingsGXMoveTransform GXMoveTransformTo GXScaleTransform GXRotateTransform GXSkewTransform GXMapTransform 1Transforming Shapes by Modifying Shape Geometries GXMoveShape GXMoveShapeTo
GXScaleShape GXRotateShape GXSkewShape
GXMapShape&Getting and Setting the View Port ListGXGetTransformViewPorts GXSetTransformViewPorts GXGetShapeViewPorts GXSetShapeViewPorts +Getting and Setting the Hit-Test ParametersGXGetTransformHitTest GXSetTransformHitTest GXGetShapeHitTest GXSetShapeHitTest
Summary of Transform ObjectsView-Related Objects/About View Ports, View Devices, and View Groups0Figure 7-1 Objects used by the drawing mechanismAbout View Port ObjectsView Port Properties&Figure 7-2 View port object propertiesView Port Clip and Mapping-Figure 7-3 Clipping and mapping in view portsDither$Table 7-1 Dither levels and patternsHalftoneFigure 7-4 Halftone angle Figure 7-5 Halftone frequency Figure 7-6 Halftone dot types<Figure 7-7 Using a color mixture to define the halftone tintParent and Child View Ports.Figure 7-8 Hierarchical view ports in a window Figure 7-9 A view port hierarchyView Port AttributesETable 7-2 View port attributes, from the gxPortAttributes enumeration The Default View Port Object View Port Objects and Windows!Figure 7-10 View ports in windowsNFigure 7-11 Adjusting a child view port’s clip and mapping to handle scrollingAbout View Device Objects/Figure 7-12 View ports overlapping view devicesView Device Properties)Figure 7-13 View device object properties View Device Clip and MappingView Device BitmapView Device AttributesRTable 7-3 View device attributes, as defined in the gxDeviceAttributes enumeration The Default View Device Object(View Device Objects and Physical DevicesAbout View Group Objects View Groups Have No Properties"Onscreen and Offscreen View Groups3
About Drawing, Coordinate Conversion, and ClippingQuickDraw GX Coordinates-Figure 7-14 The QuickDraw GX coordinate planeGeometry Space:Figure 7-15 A shape geometry and a transform clip geometry Local SpaceAFigure 7-16 Applying the transform’s clip and mapping to a shape Global SpaceGFigure 7-17 Applying the child view port’s mapping and clip to a shape HFigure 7-18 Applying the parent view port’s mapping and clip to a shape Device SpaceBFigure 7-19 Applying the view device’s mapping and clip to a shape*Figure 7-20 The shape as finally displayedUsing View-Related ObjectsUsing View Ports+Creating and Manipulating View Port Objects(Manipulating View Port Object PropertiesCListing 7-1 Changing a view port’s dither, halftone, and attributesAListing 7-2 Copying the view ports from one view group to another2Getting and Setting a View Port’s Clip and Mapping*Listing 7-3 Changing a view port’s mapping$Listing 7-4 Setting a view port clip/Setting Up the View Port Hierarchy for a Window/Listing 7-5 Setting up a view port for a window Supporting Scrolling in a Window5Listing 7-6 Supporting scrolling in a child view port&Identifying a View Port’s View Devices6Listing 7-7 Setting a shape color for XOR highlighting Identifying a Shape’s View Ports Measuring a Shape in a View PortOListing 7-8 Locating the bounding rectangles of a list of shapes in a view portUsing View Devices-Creating and Manipulating View Device Objects&Listing 7-9 Creating a new view deviceDListing 7-10 Copying the view devices from one view group to another*Manipulating View Device Object Properties4Getting and Setting a View Device’s Clip and Mapping=Listing 7-11 Returning the mapping from local to device space"Identifying a Shape’s View DevicesGListing 7-12 Setting up a data structure for offscreen drawing (part 1) Measuring a Shape on a Device Hit-Testing a Shape on a DeviceUsing View Groups,Creating and Manipulating View Group ObjectsJListing 7-13 Setting up a data structure for offscreen drawing (continued)"Setting up an Offscreen View GroupHListing 7-14 Setting up a view port and view group for offscreen drawing!Measuring a Shape in a View GroupFListing 7-15 Returning the characteristics of an offscreen device area View-Related Objects ReferenceConstants and Data TypesThe View Port Object The Halftone Structure Dot Types
Tint TypesView Port AttributesThe View Device ObjectView Device AttributesThe View Group ObjectView Group TypesView Port Functions+Creating and Manipulating View Port Objects
GXNewViewPortGXDisposeViewPortGXCopyToViewPortGXEqualViewPort(Manipulating View Port Object PropertiesGXGetViewPortClipGXSetViewPortClipGXGetViewPortMappingGXSetViewPortMappingGXGetViewPortGlobalMappingGXGetViewPortDitherGXSetViewPortDitherGXGetViewPortHalftoneGXSetViewPortHalftoneGXGetHalftoneDeviceAngleGXGetViewPortParentGXSetViewPortParentGXGetViewPortChildrenGXSetViewPortChildrenGXGetViewPortViewGroupGXSetViewPortViewGroupGXGetViewPortAttributesGXSetViewPortAttributesGXGetViewPortTagsGXSetViewPortTags6Retrieving the View Devices That Intersect a View PortGXGetViewPortViewDevices0Retrieving the View Ports that Intersect a ShapeGXGetShapeGlobalViewPorts Measuring a Shape in a View PortGXGetShapeLocalBoundsView Device Functions-Creating and Manipulating View Device ObjectsGXNewViewDeviceGXDisposeViewDeviceGXCopyToViewDeviceGXEqualViewDevice*Manipulating View Device Object PropertiesGXGetViewDeviceClipGXSetViewDeviceClipGXGetViewDeviceMappingGXSetViewDeviceMappingGXGetViewDeviceBitmapGXSetViewDeviceBitmapGXGetViewDeviceViewGroupGXSetViewDeviceViewGroupGXGetViewDeviceAttributesGXSetViewDeviceAttributesGXGetViewDeviceTagsGXSetViewDeviceTags2Retrieving the View Devices that Intersect a ShapeGXGetShapeGlobalViewDevices0Measuring and Analyzing a Shape on a View DeviceGXGetShapeDeviceBoundsGXGetShapeDeviceAreaGXGetShapeDeviceColorsGXHitTestDeviceView Group Functions,Creating and Disposing of View Group ObjectsGXNewViewGroupGXDisposeViewGroup7Getting the View Ports and View Devices of a View GroupGXGetViewGroupViewPortsGXGetViewGroupViewDevices!Measuring a Shape in Global SpaceGXGetShapeGlobalBounds
Summary of View-Related Objects Tag ObjectsAbout Tag ObjectsTag Object Properties,Figure 8-1 The tag object and its properties Tag types6Table 8-1 Defined tag types for tag objects(continued)Uses for Tag Objects
Using Tag Objects%Creating and Manipulating Tag Objects"Creating and Deleting a Tag Object2Listing 8-1 Adding data to a shape as a tag object+Copying, Comparing, and Cloning Tag Objects!Loading and Unloading Tag Objects"Manipulating Tag Object Properties8Getting and Setting a Tag Object’s Tag Type and Contents3Listing 8-2 Retrieving the contents of a tag object'Manipulating a Tag Object’s Owner Count)Directly Manipulating Tag Object Contents'Attaching Tags to a QuickDraw GX Object
Tag Objects ReferenceConstants and Data TypesThe Tag Object Functions%Creating and Manipulating Tag ObjectsGXNewTag GXDisposeTag GXCopyToTag
GXEqualTag
GXCloneTag"Manipulating Tag Object PropertiesGXGetTagGXSetTagGXGetTagOwners.Directly Manipulating the Data in a Tag Object GXLockTag GXUnlockTagGXGetTagStructureSummary of Tag ObjectsGlossaryIndex
